Inside Macintosh: QuickTime Components /

Chapter 8 - Video Digitizer Components / Video Digitizer Components Reference

Video Digitizer Component Functions / Setting Video Destinations

VDGetPlayThruDestination

The VDGetPlayThruDestination function allows applications to obtain information about the current video destination.

All video digitizer components must support this function.

pascal VideoDigitizerError VDGetPlayThruDestination
                            (VideoDigitizerComponent ci,
                              PixMapHandle *dest, Rect *destRect,
                              MatrixRecord *m, RgnHandle *mask);

ci

Specifies the video digitizer component for the request. Applications obtain this reference from the Component Manager's OpenComponent function.

dest

Contains a pointer to a pixel map handle. The video digitizer component returns a handle to the destination pixel map in the field referred to by this parameter. It is the caller's responsibility to dispose of the pixel map.

destRect

Contains a pointer to a rectangle structure. The video digitizer component places the coordinates of the output rectangle into the structure referred to by this parameter. If there is no output rectangle defined, the component returns an empty rectangle.

m

Contains a pointer to a matrix structure. The video digitizer component places the transformation matrix into the structure referred to by this parameter.

mask

Contains a pointer to a region handle. The video digitizer component places a handle to the mask region into the field referred to by this parameter. Applications can use masks to control the video into the destination rectangle. For more information about masks, see "About Video Digitizer Components," which begins on page 8-3. If there is no mask region defined, the digitizer component sets this returned handle to nil. The caller is responsible for disposing of this region.

DESCRIPTION

Applications can set the video destination by calling either the VDSetPlayThruDestination function (described on page 8-35) or
the VDSetPlayThruGlobalRect function (described in the next section). Applications should call the VDGetPlayThruDestination function only after having set the destination with the VDSetPlayThruDestination function.

RESULT CODE

noErr

0

No error

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help